home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1994 April / Inside Multimedia CD-ROM (April 1994).iso / prg / gs / gssource.exe / STD.H < prev    next >
Encoding:
C/C++ Source or Header  |  1992-09-03  |  12.5 KB  |  322 lines
  1. /* Copyright (C) 1989, 1992 Aladdin Enterprises.  All rights reserved.
  2.    Distributed by Free Software Foundation, Inc.
  3.  
  4. This file is part of Ghostscript.
  5.  
  6. Ghostscript is distributed in the hope that it will be useful, but
  7. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  8. to anyone for the consequences of using it or for whether it serves any
  9. particular purpose or works at all, unless he says so in writing.  Refer
  10. to the Ghostscript General Public License for full details.
  11.  
  12. Everyone is granted permission to copy, modify and redistribute
  13. Ghostscript, but only under the conditions described in the Ghostscript
  14. General Public License.  A copy of this license is supposed to have been
  15. given to you along with Ghostscript so you can know your rights and
  16. responsibilities.  It should be in a file named COPYING.  Among other
  17. things, the copyright notice and this notice must be preserved on all
  18. copies.  */
  19.  
  20. /* std.h */
  21. /* Standard definitions for Aladdin Enterprises code */
  22.  
  23. #ifndef std_INCLUDED
  24. #  define std_INCLUDED
  25.  
  26. /* Include the architecture definitions. */
  27. #include "arch.h"
  28. #define arch_ints_are_short (arch_sizeof_int == arch_sizeof_short)
  29.  
  30. /*
  31.  * Here we deal with the vagaries of various C compilers.  We assume that:
  32.  *    ANSI-standard Unix compilers define __STDC__.
  33.  *    Turbo C and Turbo C++ define __MSDOS__ and __TURBOC__.
  34.  *    Borland C++ defines __BORLANDC__, __MSDOS__, and __TURBOC__.
  35.  *    Microsoft C defines MSDOS.
  36.  *    Watcom C defines __WATCOMC__ and MSDOS.
  37.  * We arrange to define __MSDOS__ on all the MS-DOS platforms.
  38.  * Also, not used much here, but used in other header files, we assume:
  39.  *    Unix System V environments define USG or SYSV.
  40.  *      (GNU software uses the former, non-GNU tends to use the latter.)
  41.  *    VMS systems define VMS.
  42.  *      (The VMS C compiler handles prototypes and const, but does not
  43.  *      define __STDC__.)
  44.  *    bsd 4.2 or 4.3 systems define BSD4_2.
  45.  *    POSIX-compliant environments define _POSIX_SOURCE.
  46.  *    Motorola 88K BCS/OCS systems defined m88k.
  47.  *
  48.  * We make fairly heroic efforts to confine all uses of these flags to
  49.  * header files, and never to use them in code.
  50.  */
  51.  
  52. #if defined(__STDC__) || defined(__MSDOS__) || defined(__convex__) || defined(VMS)
  53. #  define __PROTOTYPES__ /* */
  54. #endif
  55.  
  56. /* Recognize USG and SYSV as synonyms.  GNU software uses the former, */
  57. /* non-GNU tends to use the latter.  We use the latter. */
  58. #ifdef USG
  59. #  define SYSV /* */
  60. #endif
  61.  
  62. /* Define dummy values for __FILE__ and __LINE__ if the compiler */
  63. /* doesn't provide these.  Note that places that use __FILE__ */
  64. /* must check explicitly for a null pointer. */
  65. #ifndef __FILE__
  66. #  define __FILE__ NULL
  67. #endif
  68. #ifndef __LINE__
  69. #  define __LINE__ 0
  70. #endif
  71.  
  72. /* Disable 'const' if the compiler can't handle it. */
  73. #ifndef __PROTOTYPES__
  74. #  define const /* */
  75. #endif
  76.  
  77. /* Disable MS-DOS specialized pointer types on non-MS-DOS systems. */
  78. /* Watcom C defines near, far, and huge as macros, so we must undef them. */
  79. #ifndef __TURBOC__
  80. #  undef near
  81. #  define near /* */
  82. #  undef far
  83. #  define far /* */
  84. #  undef huge
  85. #  define huge /* */
  86. #  define _cs /* */
  87. #  define _ds /* */
  88. /* _es is never safe to use */
  89. #  define _ss /* */
  90. #endif
  91.  
  92. /* Define a couple of useful language extensions. */
  93. /* Get the size of a statically declared array. */
  94. #define countof(a) (sizeof(a) / sizeof((a)[0]))
  95.  
  96. /* Define short names for the unsigned types. */
  97. typedef unsigned char byte;
  98. typedef unsigned char uchar;
  99. typedef unsigned short ushort;
  100. typedef unsigned int uint;
  101. typedef unsigned long ulong;
  102.  
  103. /* Since sys/types.h often defines one or more of these (depending on */
  104. /* the platform), we have to take steps to prevent name clashes. */
  105. /*** NOTE: This requires that you include std.h *before* any other ***/
  106. /*** header file that includes sys/types.h. ***/
  107. #define uchar uchar_
  108. #define uint uint_
  109. #define ushort ushort_
  110. #define ulong ulong_
  111. #include <sys/types.h>
  112. #undef uchar
  113. #undef uint
  114. #undef ushort
  115. #undef ulong
  116.  
  117. /* Maximum values for the unsigned types. */
  118. /* The "+0" is to get around apparent bugs in the UTek compiler. */
  119. #define max_uchar ((uchar)0xff + (uchar)0)
  120. #define max_ushort ((ushort)0xffff + (ushort)0)
  121. #define max_uint ((uint)0xffffffff + (uint)0)
  122. #define max_ulong ((ulong)0xffffffffL + (ulong)0)
  123.  
  124. /* Define a reliable arithmetic right shift. */
  125. /* Must use arith_rshift_1 for a shift by a literal 1. */
  126. #define arith_rshift_slow(x,n) ((x) < 0 ? ~(~(x) >> (n)) : (x) >> (n))
  127. #if arch_arith_rshift == 2
  128. #  define arith_rshift(x,n) ((x) >> (n))
  129. #  define arith_rshift_1(x) ((x) >> 1)
  130. #else
  131. #if arch_arith_rshift == 1        /* OK except for n=1 */
  132. #  define arith_rshift(x,n) ((x) >> (n))
  133. #  define arith_rshift_1(x) arith_rshift_slow(x,1)
  134. #else
  135. #  define arith_rshift(x,n) arith_rshift_slow(x,n)
  136. #  define arith_rshift_1(x) arith_rshift_slow(x,1)
  137. #endif
  138. #endif
  139.  
  140. /* The type to be used for comparing pointers for order (<, >=, etc.). */
  141. /* Turbo C large model doesn't compare pointers per se correctly. */
  142. #ifdef __MSDOS__
  143. typedef unsigned long ptr_ord_t;
  144. #else
  145. typedef char *ptr_ord_t;
  146. #endif
  147. /* Define all the pointer comparison operations. */
  148. #define _ptr_cmp(p1, rel, p2)  ((ptr_ord_t)(p1) rel (ptr_ord_t)(p2))
  149. #define ptr_le(p1, p2) _ptr_cmp(p1, <=, p2)
  150. #define ptr_lt(p1, p2) _ptr_cmp(p1, <, p2)
  151. #define ptr_ge(p1, p2) _ptr_cmp(p1, >=, p2)
  152. #define ptr_gt(p1, p2) _ptr_cmp(p1, >, p2)
  153. #define ptr_between(ptr, lo, hi)\
  154.   (ptr_ge(ptr, lo) && ptr_lt(ptr, hi))
  155.  
  156. /* In case stdio.h doesn't have these: */
  157. #ifndef min
  158. #  define min(a, b) ((a) < (b) ? (a) : (b))
  159. #endif
  160. #ifndef max
  161. #  define max(a, b) ((a) > (b) ? (a) : (b))
  162. #endif
  163.  
  164. /* VMS doesn't have the unlink system call.  Use delete instead. */
  165. #ifdef VMS
  166. #  define unlink(fname) delete(fname)
  167. #endif
  168.  
  169. /* K&R specifies that float parameters get converted to double. */
  170. /* However, if we pass a float to a function that has been declared */
  171. /* with a prototype, and the parameter has been declared as float, */
  172. /* the ANSI standard specifies that the parameter is left as float. */
  173. /* To avoid problems when mixing ANSI and non-ANSI compilation, */
  174. /* we declare all float parameters as double. */
  175. typedef double floatp;
  176.  
  177. /* If we are debugging, make all static variables and procedures public */
  178. /* so they get passed through the linker. */
  179. #ifdef NOPRIVATE
  180. # define private /* */
  181. #else
  182. # define private static
  183. #endif
  184.  
  185. /*
  186.  * Macros for argument templates.  ANSI C has these, as does Turbo C,
  187.  * but older pcc-derived (K&R) Unix compilers don't.  The syntax is
  188.  *    resulttype func(Pn(arg1, ..., argn));
  189.  */
  190.  
  191. #ifdef __PROTOTYPES__
  192. # define P0() void
  193. # define P1(t1) t1
  194. # define P2(t1,t2) t1,t2
  195. # define P3(t1,t2,t3) t1,t2,t3
  196. # define P4(t1,t2,t3,t4) t1,t2,t3,t4
  197. # define P5(t1,t2,t3,t4,t5) t1,t2,t3,t4,t5
  198. # define P6(t1,t2,t3,t4,t5,t6) t1,t2,t3,t4,t5,t6
  199. # define P7(t1,t2,t3,t4,t5,t6,t7) t1,t2,t3,t4,t5,t6,t7
  200. # define P8(t1,t2,t3,t4,t5,t6,t7,t8) t1,t2,t3,t4,t5,t6,t7,t8
  201. # define P9(t1,t2,t3,t4,t5,t6,t7,t8,t9) t1,t2,t3,t4,t5,t6,t7,t8,t9
  202. # define P10(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10) t1,t2,t3,t4,t5,t6,t7,t8,t9,t10
  203. # define P11(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11) t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11
  204. # define P12(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11,t12) t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11,t12
  205. #else
  206. # define P0() /* */
  207. # define P1(t1) /* */
  208. # define P2(t1,t2) /* */
  209. # define P3(t1,t2,t3) /* */
  210. # define P4(t1,t2,t3,t4) /* */
  211. # define P5(t1,t2,t3,t4,t5) /* */
  212. # define P6(t1,t2,t3,t4,t5,t6) /* */
  213. # define P7(t1,t2,t3,t4,t5,t6,t7) /* */
  214. # define P8(t1,t2,t3,t4,t5,t6,t7,t8) /* */
  215. # define P9(t1,t2,t3,t4,t5,t6,t7,t8,t9) /* */
  216. # define P10(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10) /* */
  217. # define P11(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11) /* */
  218. # define P12(t1,t2,t3,t4,t5,t6,t7,t8,t9,t10,t11,t12) /* */
  219. #endif
  220.  
  221. /* Types for client-supplied allocate and free procedures. */
  222. /* For accountability, debugging, and error messages, */
  223. /* we pass an identifying string to alloc and free. */
  224. /* Note that the arguments are like calloc, not like malloc, */
  225. /* but an alloc procedure doesn't clear the block. */
  226. typedef char *(*proc_alloc_t)(P3(unsigned num_elements, unsigned element_size, const char *client_name));
  227. typedef void (*proc_free_t)(P4(char *data, unsigned num_elements, unsigned element_size, const char *client_name));
  228.  
  229. /* Standard error printing macros. */
  230. /* Use dprintf for messages that just go to dstderr, */
  231. /* eprintf for error messages to estderr that include the program name, */
  232. /* lprintf for debugging messages that should include line number info. */
  233.  
  234. /* dstderr and estderr may be redefined. */
  235. #define dstderr stderr
  236. #define estderr stderr
  237.  
  238. #define dputc(chr) fputc(chr, dstderr)
  239. #define dputs(str) fputs(str, dstderr)
  240. #define dprintf(str)\
  241.   fprintf(dstderr, str)
  242. #define dprintf1(str,arg1)\
  243.   fprintf(dstderr, str, arg1)
  244. #define dprintf2(str,arg1,arg2)\
  245.   fprintf(dstderr, str, arg1, arg2)
  246. #define dprintf3(str,arg1,arg2,arg3)\
  247.   fprintf(dstderr, str, arg1, arg2, arg3)
  248. #define dprintf4(str,arg1,arg2,arg3,arg4)\
  249.   fprintf(dstderr, str, arg1, arg2, arg3, arg4)
  250. #define dprintf5(str,arg1,arg2,arg3,arg4,arg5)\
  251.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5)
  252. #define dprintf6(str,arg1,arg2,arg3,arg4,arg5,arg6)\
  253.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5, arg6)
  254. #define dprintf7(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7)\
  255.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
  256. #define dprintf8(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8)\
  257.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
  258. #define dprintf9(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9)\
  259.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9)
  260. #define dprintf10(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9,arg10)\
  261.   fprintf(dstderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10)
  262.  
  263. #ifdef PROGRAM_NAME
  264. #  define _epn fprintf(estderr, "%s: ", PROGRAM_NAME),
  265. #else
  266. #  define _epn /* */
  267. #endif
  268.  
  269. #define eprintf(str)\
  270.   (_epn fprintf(estderr, str))
  271. #define eprintf1(str,arg1)\
  272.   (_epn fprintf(estderr, str, arg1))
  273. #define eprintf2(str,arg1,arg2)\
  274.   (_epn fprintf(estderr, str, arg1, arg2))
  275. #define eprintf3(str,arg1,arg2,arg3)\
  276.   (_epn fprintf(estderr, str, arg1, arg2, arg3))
  277. #define eprintf4(str,arg1,arg2,arg3,arg4)\
  278.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4))
  279. #define eprintf5(str,arg1,arg2,arg3,arg4,arg5)\
  280.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5))
  281. #define eprintf6(str,arg1,arg2,arg3,arg4,arg5,arg6)\
  282.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6))
  283. #define eprintf7(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7)\
  284.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7))
  285. #define eprintf8(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8)\
  286.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8))
  287. #define eprintf9(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9)\
  288.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9))
  289. #define eprintf10(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9,arg10)\
  290.   (_epn fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10))
  291.  
  292. #if __LINE__                /* compiler provides it */
  293. #  define _epl _epn fprintf(estderr, "%s(%d): ", __FILE__, __LINE__),
  294. #else
  295. #  define _epl _epn
  296. #endif
  297.  
  298. #define lprintf(str)\
  299.   (_epl fprintf(estderr, str))
  300. #define lprintf1(str,arg1)\
  301.   (_epl fprintf(estderr, str, arg1))
  302. #define lprintf2(str,arg1,arg2)\
  303.   (_epl fprintf(estderr, str, arg1, arg2))
  304. #define lprintf3(str,arg1,arg2,arg3)\
  305.   (_epl fprintf(estderr, str, arg1, arg2, arg3))
  306. #define lprintf4(str,arg1,arg2,arg3,arg4)\
  307.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4))
  308. #define lprintf5(str,arg1,arg2,arg3,arg4,arg5)\
  309.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5))
  310. #define lprintf6(str,arg1,arg2,arg3,arg4,arg5,arg6)\
  311.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6))
  312. #define lprintf7(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7)\
  313.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7))
  314. #define lprintf8(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8)\
  315.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8))
  316. #define lprintf9(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9)\
  317.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9))
  318. #define lprintf10(str,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9,arg10)\
  319.   (_epl fprintf(estderr, str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10))
  320.  
  321. #endif                    /* std_INCLUDED */
  322.